home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / arc / uucoders.readme < prev    next >
Text File  |  1992-09-27  |  4KB  |  136 lines
  1. Short: Fast uuencode/uudecode
  2.  
  3.  
  4.  
  5.                            UUCoders version 1.02
  6.                                 2 May, 1992
  7.  
  8.                              by  Michel Bekker
  9.  
  10.  
  11.  
  12.      What are UUCoders?
  13.      ------------------
  14.  
  15.         UUCoders are used to send a binary file via uucp or other
  16.      electronic mail systems.
  17.  
  18.         There are two kind of uucoders, one to encrypt a binary file
  19.      so that the output will only contain printable characters so it
  20.      can be placed in a message area. This is called uuencoding.
  21.  
  22.         The other one decrypts an uuencode't file to it's binary
  23.      origin. This is called uudecoding.
  24.  
  25.  
  26.      UUEncodeX
  27.      ---------
  28.  
  29.      Usage: UUEncodeX [-bX] <infile> <outfile> [NAME] [FLAGS] [NOCHECK]
  30.  
  31.      option -b  use only the basename as filename
  32.  
  33.      option -X  adds after every encoded line an 'X'
  34.  
  35.      <infile>   name of the binary file which must be encoded
  36.  
  37.      <outfile>  name of the file which must contain the encoded lines
  38.                 of the binary file
  39.  
  40.      [NAME]     the name you want to call the binary file after decoding
  41.                 (if not given, <infile> is used)
  42.  
  43.      [FLAGS]    set a protection mode (Unix style, 000 - 777)
  44.                 Default is 644
  45.  
  46.      [NOCHECK]  don't add a checksum after each encoded line
  47.  
  48.  
  49.         UUEncodeX places a filesize at the end of the encoded file which
  50.      can be used by decoding as a check.
  51.  
  52.         If the output-file already exists, UUEncodeX will ask you if you
  53.      want to overwrite it.
  54.  
  55.  
  56.      UUDecodeX
  57.      ---------
  58.  
  59.      Usage: UUDecodeX [-b] [-d <destdir>] <infile> [NOCHECK]
  60.  
  61.      option -b  use only the basename of the encoded file
  62.  
  63.      option -d  followed by a directory, write the origin file to the
  64.                 specified directory
  65.  
  66.      <infile>   the name of the encoded file which must be decoded
  67.  
  68.      [NOCHECK]  don't check the checksums given after each line (if
  69.                 present)
  70.  
  71.  
  72.         You don't have to strip any leading lines added by mailers,
  73.      UUDecodeX will do it himself.
  74.  
  75.         UUDecodeX can handle encoded files which have checksums, 'X'
  76.      terminated lines or not. Any combination of these two options are
  77.      handled perfectly by UUDecodeX.
  78.  
  79.         If a size is given at the end of the encoded file UUDecodeX
  80.      will check if this matches with the size of the binary file it
  81.      decoded.
  82.  
  83.  
  84.      Why did I made this programs?
  85.      -----------------------------
  86.  
  87.         I encode and decode a lot of programs each day. The uucoders I
  88.      had were not fast and the fastest one was larger than 10 kB.  And
  89.      i like to program.
  90.  
  91.  
  92.      How to contact me?
  93.      ------------------
  94.  
  95.         If you have any bug-reports, suggestions, comments etc. you can
  96.      contact me on:
  97.  
  98.      Email    : michelb@solist.htsa.ah.nl or
  99.                 michelb@maestro.htsa.ah.nl
  100.      FidoNet  : 2:280/303.6
  101.  
  102.      or you can write me on :
  103.  
  104.      Michel Bekker
  105.      Comeniusstraat 161 hs
  106.      1065 BK  AMSTERDAM
  107.      HOLLAND
  108.  
  109.  
  110.      Version changes:
  111.  
  112.      v1.0   3 April 1992
  113.  
  114.      - First release, works with every Kickstart
  115.  
  116.      v1.01  5 April 1992
  117.  
  118.      - second release, KS 2.0 and up only
  119.  
  120.      - added break option (Ctrl C) in both uucoders
  121.  
  122.      - rewrote some routines and made the code smaller
  123.  
  124.      v1.02  3 May 1992
  125.  
  126.      - added the basename option in UUEncodeX and UUDecodeX
  127.  
  128.      - added the destination directory in UUDecodeX
  129.  
  130.      - added the NOCHECK option in UUDecodeX
  131.  
  132.      - rewrote some routines, more use of dos.library v36+
  133.  
  134.                                     ---
  135.  
  136.